This contains the source and compiled classes for jax and jell,
a scanner generator and parser generator for java.

QUICK CHECK for jell:

From this directory, run
> java sbktech.tools.jell.driver examples/expr1.gram
> java sbktech.tools.jax.driver -lexFile TokenInputStream.java examples/expr.lex
> javac parser.java

This creates a small expression interpreter. Run the interpreter with
a sample input
> java parser < examples/expr.inp
Result is 3
>

QUICK CHECK for jax:

From this directory, run
> java sbktech.tools.jax.driver -lexFile wc.java examples/wc.lex
> javac wc.java

This creates a word counting lexer. Run it with (say)
> java wc < wc.java
678 words
> 

The latest documentation for jax and jell is at http://www.blackdown.org/~kbs
I've included a copy of the docs for jax and jell in the doc
directory. The sources are under the src directory, the examples and
bnchmark directories contain files referred to in the documentation.

WARNING:
jell and jax is *alpha* code, and the only thing I know is that they
can both bootstrap their scanners and parsers identically. Please
mail me bug reports, and I'll try to fix them as quickly as I can.

UPGRADES:
To check for upgrades, and install one if it is available, please
run from this directory:

% java upgrade

USAGE:
jell and jax can be freely used/modified/sold/processed as llama fodder
with absolutely no restrictions. Just add a note somewhere where you
got it from.

Hope this stuff is useful :)

ACKNOWLEDGEMENTS:
Many thanks to everybody for sending bug reports/fixes/suggestions
for jax and jell. I hope I've remembered everybody -- Andrew Turk
sent fixes to get code to compile with Symantec's compiler, and
prodded the case insensitive option. Alexander Osipov, Matt Kimball,
Marc Ericson, Marian Trnkus for comments and bug reports in jax and
jell, A. P. Rao for several nice suggestions to augment jell
(alas, not found time to incorporate them yet)

Errors that remain are mine, please do send me bug reports so
I can make these more robust and usable.

-KB-
kbs@sbktech.org
Version created: Mon Jul 29 23:53:16 PDT 1996
